﻿/******************************************************************************************************************************

 * @ Original idea by by Binny V A, Original version: 2.00.A 
 * @ http://www.openjs.com/scripts/events/keyboard_shortcuts/
 * @ Original License : BSD
 
 * @ jQuery Plugin by Tzury Bar Yochay 
        mail: tzury.by@gmail.com
        blog: evalinux.wordpress.com
        face: facebook.com/profile.php?id=513676303
        
        (c) Copyrights 2007
        
 * @ jQuery Plugin version Beta (0.0.2)
 * @ License: jQuery-License.
 
TODO:
    add queue support (as in gmail) e.g. 'x' then 'y', etc.
    add mouse + mouse wheel events.

USAGE:
    $.hotkeys.add('Ctrl+c', function(){ alert('copy anyone?');});
    $.hotkeys.add('Ctrl+c', {target:'div#editor', type:'keyup', propagate: true},function(){ alert('copy anyone?');});>
    $.hotkeys.remove('Ctrl+c'); 
    $.hotkeys.remove('Ctrl+c', {target:'div#editor', type:'keypress'}); 
    
******************************************************************************************************************************/
(function (jQuery) {
	this.version = '(beta)(0.0.3)';
	this.all = {};
	this.special_keys = {
		27: 'esc', 9: 'tab', 32: 'space', 13: 'return', 8: 'backspace', 145: 'scroll', 20: 'capslock',
		144: 'numlock', 19: 'pause', 45: 'insert', 36: 'home', 46: 'del', 35: 'end', 33: 'pageup',
		34: 'pagedown', 37: 'left', 38: 'up', 39: 'right', 40: 'down', 112: 'f1', 113: 'f2', 114: 'f3',
		115: 'f4', 116: 'f5', 117: 'f6', 118: 'f7', 119: 'f8', 120: 'f9', 121: 'f10', 122: 'f11', 123: 'f12'
	};

	this.shift_nums = {
		"`": "~", "1": "!", "2": "@", "3": "#", "4": "$", "5": "%", "6": "^", "7": "&",
		"8": "*", "9": "(", "0": ")", "-": "_", "=": "+", ";": ":", "'": "\"", ",": "<",
		".": ">", "/": "?", "\\": "|"
	};

	this.add = function (combi, options, callback) {
		if (jQuery.isFunction(options)) {
			callback = options;
			options = {};
		}
		var opt = {},
            defaults = { type: 'keydown', propagate: false, disableInInput: false, target: jQuery('html')[0], checkParent: true },
            that = this;
		opt = jQuery.extend(opt, defaults, options || {});
		combi = combi.toLowerCase();

		// inspect if keystroke matches
		var inspector = function (event) {
			event = jQuery.event.fix(event); // jQuery event normalization.
			var element = event.target;
			// @ TextNode -> nodeType == 3
			element = (element.nodeType == 3) ? element.parentNode : element;

			if (opt['disableInInput']) { // Disable shortcut keys in Input, Textarea fields
				var target = jQuery(element);
				if (target.is("input") || target.is("textarea")) {
					return;
				}
			}
			var code = event.which,
                type = event.type,
                character = String.fromCharCode(code).toLowerCase(),
                special = that.special_keys[code],
                shift = event.shiftKey,
                ctrl = event.ctrlKey,
                alt = event.altKey,
                propagate = true, // default behaivour
                mapPoint = null;

			// in opera + safari, the event.target is unpredictable.
			// for example: 'keydown' might be associated with HtmlBodyElement 
			// or the element where you last clicked with your mouse.
			if (jQuery.browser.opera || jQuery.browser.safari || opt.checkParent) {
				while (!that.all[element] && element.parentNode) {
					element = element.parentNode;
				}
			}

			var cbMap = that.all[element].events[type].callbackMap;
			if (!shift && !ctrl && !alt) { // No Modifiers
				mapPoint = cbMap[special] || cbMap[character]
			}
				// deals with combinaitons (alt|ctrl|shift+anything)
			else {
				var modif = '';
				if (alt) modif += 'alt+';
				if (ctrl) modif += 'ctrl+';
				if (shift) modif += 'shift+';
				// modifiers + special keys or modifiers + characters or modifiers + shift characters
				mapPoint = cbMap[modif + special] || cbMap[modif + character] || cbMap[modif + that.shift_nums[character]]
			}
			if (mapPoint) {
				mapPoint.cb(event);
				if (!mapPoint.propagate) {
					event.stopPropagation();
					event.preventDefault();
					return false;
				}
			}
		};
		// first hook for this element
		if (!this.all[opt.target]) {
			this.all[opt.target] = { events: {} };
		}
		if (!this.all[opt.target].events[opt.type]) {
			this.all[opt.target].events[opt.type] = { callbackMap: {} }
			jQuery.event.add(opt.target, opt.type, inspector);
		}
		this.all[opt.target].events[opt.type].callbackMap[combi] = { cb: callback, propagate: opt.propagate };
		return jQuery;
	};
	this.remove = function (exp, opt) {
		opt = opt || {};
		target = opt.target || jQuery('html')[0];
		type = opt.type || 'keydown';
		exp = exp.toLowerCase();
		delete this.all[target].events[type].callbackMap[exp]
		return jQuery;
	};
	jQuery.hotkeys = this;
	return jQuery;
})(jQuery);